# PHP setlocale() Function

PHP String Reference

## Example

Set the locale to US English and then back to default again:

<?php
echo setlocale(LC_ALL,"US");
echo "<br>";
echo setlocale(LC_ALL,NULL);
?>
Run example »

## Definition and Usage

The setlocale() function sets locale information.

Locale information is language, monetary, time and other information specific for a geographical area.

Note: The setlocale() function changes the locale only for the current script.

Tip: The locale information can be set to system default with setlocale(LC_ALL,NULL)

Tip: To get numeric formatting information, see the localeconv() function.

## Syntax

setlocale(constant,location)

Parameter | Description
--- | ---

constant

Required. Specifies what locale information should be set.

Available constants:

- LC_ALL - All of the below
- LC_COLLATE - Sort order
- LC_CTYPE - Character classification and conversion (e.g. all characters should be lower or upper-case)
- LC_MESSAGES - System message formatting
- LC_MONETARY - Monetary/currency formatting
- LC_NUMERIC - Numeric formatting
- LC_TIME - Date and time formatting

location

Required. Specifies what country/region to set the locale information to. Can be a string or an array. It is possible to pass multiple locations.
If the location is NULL or the empty string "", the location names will be set from the values of environment variables with the same names as the constants above, or from "LANG".
If the location is "0", the location setting is not affected, only the current setting is returned.
If the location is an array, setlocale() will try each array element until it finds a valid language or region code. This is very useful if a region is known under different names on different systems.

Note: To view all available language codes, go to our Language code reference.

## Technical Details

Return Value: | Returns the current locale settings, or FALSE on failure. The return value depends on the system that PHP is running.
PHP Version: | 4+
Changelog: | Passing constant as a string was deprecated in PHP 4.2.0. Use the available constants instead. Passing them as a string will result in a warning message. Passing multiple locations became possible in PHP 4.3.0. If a string is passed to the constant parameter instead of one of the LC_ constants, this function throws an E_DREPRECATED notice as of PHP 5.3.0.

PHP String Reference

### WEB HOSTING

UK Reseller Hosting

### WEB BUILDING

FREE Website BUILDER Free HTML5 Templates

### W3SCHOOLS EXAMS

HTML, CSS, JavaScript, PHP, jQuery, XML, and ASP Certifications

### SHARE THIS PAGE

### Color Picker

### HTML/CSS

HTML Tutorial HTML5 Tutorial CSS Tutorial CSS3 Tutorial Bootstrap Tutorial

### JavaScript

JavaScript Tutorial jQuery Tutorial jQuery Mobile Tutorial AngularJS Tutorial AJAX Tutorial JSON Tutorial

### Graphics

Canvas Tutorial SVG Tutorial Google Maps Tutorial

### Server Side

SQL Tutorial PHP Tutorial ASP Tutorial ASP.NET Tutorial VBScript Tutorial AppML Tutorial

### Web

Web Building Web Statistics Web Certification

### XML

XML Tutorial DTD Tutorial Schema Tutorial XML DOM Tutorial XPath Tutorial XSLT Tutorial XQuery Tutorial XSL-FO Tutorial RSS Tutorial WSDL Tutorial

### HTML/CSS

HTML Tag Reference HTML Event Reference HTML Color Reference CSS 1,2,3 Reference Bootstrap Reference

### JavaScript

JavaScript Reference HTML DOM Reference jQuery Reference jQuery Mobile Reference Google Maps Reference

### Server Side

PHP Reference SQL Reference ASP Reference VBScript Reference Razor Reference ASP.NET Reference

### XML

XML DOM Reference XSLT Reference XSL-FO Reference XPath Reference XQuery Reference Schema Reference RSS Reference SVG Reference

### HTML Charsets

HTML Character Sets HTML ASCII HTML ANSI HTML Windows-1252 HTML ISO-8859-1 HTML Symbols HTML UTF-8

### HTML/CSS

HTML Examples CSS Examples

### Browser Scripting

JavaScript Examples HTML DOM Examples jQuery Examples jQuery Mobile Examples AngularJS Examples AJAX Examples

### Server Scripting

PHP Examples ASP Examples VBScript Examples Razor Examples .NET Examples

### XML Languages

XML Examples DTD Examples XML DOM Examples XSL Examples XSLT Examples XPath Examples XQuery Examples Schema Examples RSS Examples SVG Examples